3D Graphics Programming with QuickDraw 3D 1.5.4

Camera View Commands

The viewType parameter to the Q3SetCameraView function [link] is a camera view command that specifies how to change the current camera view. These commands set the viewer to a predefined camera view.

Q3SetCameraView and the associated camera view commands were introduced in version 1.1 of the 3D Viewer.



 
typedef enum TQ3ViewerCameraView {

    kQ3ViewerCameraRestore,

    kQ3ViewerCameraFit,

    kQ3ViewerCameraFront,

    kQ3ViewerCameraBack,

    kQ3ViewerCameraLeft,

    kQ3ViewerCameraRight,

    kQ3ViewerCameraTop,

    kQ3ViewerCameraBottom

} TQ3ViewerCameraView;

Constant descriptions

kQ3ViewerCameraRestore: Set the camera view to its original position. Calling Q3SetCameraView with this camera view command is the same as calling the Q3ViewerRestoreView function.
kQ3ViewerCameraFit: Set the camera view so that the 3D model fits entirely within the content area of the viewer.
kQ3ViewerCameraFront: Set the camera view to look at the front of the model.
kQ3ViewerCameraBack: Set the camera view to look at the back of the model.
kQ3ViewerCameraLeft: Set the camera view to look at the left side of the model.
kQ3ViewerCameraRight: Set the camera view to look at the right side of the model.
kQ3ViewerCameraTop: Set the camera view to look at the top of the model.
kQ3ViewerCameraBottom: Set the camera view to look at the bottom of the model.

The six final camera view commands set the camera to predefined positions based on the front and top attributes in the model only if they are present in the model's data. Otherwise, the camera positions are calculated from the model's coordinate space.